home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / tcpip / cuttcp / setup.txt < prev    next >
Encoding:
Text File  |  1992-12-27  |  19.5 KB  |  592 lines

  1.  
  2.  
  3.  
  4.  
  5. May 22, 1987                                          page 1
  6.  
  7.  
  8. To:    All TCP/IP system programmers
  9. From:  Eric Norman
  10. About: Generic Network Setup.
  11.  
  12.  
  13.  
  14. _1.  _I_n_t_r_o_d_u_c_t_i_o_n.
  15.  
  16.      This note is addressed to all  system  programmers  who
  17. are  installing  or  maintaining  network software using the
  18. TCP/IP suite of protocols.  I will attempt to mention things
  19. that  you  should  know  before  connecting your host to the
  20. campus network.  Since this is supposed  to  be  useful  for
  21. all,  I  cannot give precise details about setting up a net-
  22. work connection; however, details will often  be  given  for
  23. common  operating  systems (notably Unix and its derivatives
  24. and WIN/VX from The Wollongong  Group).   Since  the  campus
  25. network  is  a resource that is shared by all departments on
  26. campus; I will also point out some things that you should be
  27. careful  about so that you do not interfere with other users
  28. of the network.
  29.  
  30. _2.  _H_o_s_t _i_d_e_n_t_i_f_i_c_a_t_i_o_n.
  31.  
  32.      We expect that all hosts attached to the campus network
  33. be  registered so that we know where they are, what software
  34. they are running, and whom to contact in  case  of  trouble.
  35. They  should be registered with the network administrator at
  36. MACC.  Currently that's  me  (Eric  Norman;  262-3854;  3153
  37. MACC).   It would be easiest for me if this information were
  38. provided in the following form:
  39.  
  40.  
  41.     Domain:         macc.wisc.edu
  42.  
  43.     Name:           vms
  44.     Aliases:        bossie wircs1 wiscmacc vms
  45.     Interfaces:     128.104.30.10
  46.     Services:       (TCP) Telnet FTP SMTP Finger
  47.     -               (UDP) Who
  48.     CPU:            VAX-11/785
  49.     OS:             VMS (with Eunice)
  50.     Location:       MACC; 1210 West Dayton Street
  51.     Contact:        Eric Norman; 262-3854
  52.     -               <ejnorman@unix.macc.wisc.edu>
  53.  
  54.  
  55.  
  56. _2._1.  _O_f_f_i_c_i_a_l _h_o_s_t _n_a_m_e_s.
  57.  
  58.      The name space of the Internet community is  structured
  59. along  what  are  designed  to be administrative boundaries.
  60. The local convention is that official host names look  like:
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. May 22, 1987                                          page 2
  72.  
  73.  
  74. "host.dept.wisc.edu".   The  "wisc.edu"  part is dictated by
  75. the fact that we are an educational  institution  (edu)  and
  76. that  we are the one in Wisconsin (wisc.edu).  The next sub-
  77. division is according to department (dept.wisc.edu would  be
  78. the  domain above), and finally individual hosts within that
  79. department.  For instance, "larry.sal.wisc.edu" is a host in
  80. the  Space-Astronomy  laboratory, "bert.chem.wisc.edu", is a
  81. host in the Chemistry department, and so forth.
  82.  
  83. _2._2.  _N_i_c_k_n_a_m_e_s.
  84.  
  85.      For local convenience, hosts generally have  a  set  of
  86. nicknames  that  they  are known by.  Note that this is only
  87. local; such nicknames will not  be  known  in  the  external
  88. world  (i.e.  outside of the University of Wisconsin), where
  89. the long, official name should be used.  Most  people  adopt
  90. at least the first part of their official name as a nickname
  91. (e.g. "daryl.sal.wisc.edu" has a nickname  "daryl").   Other
  92. nicknames  might  be  used if the host is known by different
  93. names on different networks.  "Daryl" above also has  DECnet
  94. connections,  where  he  is known as "uwsal", so he also has
  95. that as a nickname.
  96.  
  97.      Most organizations choose a theme for their  nicknames,
  98. Computer  Sciences  names  their  Microvaxes  after cheeses,
  99. Milwaukee uses beers, MACC and a  few  other  places  around
  100. campus  use  cows,  etc.   This  is not just "cute", it also
  101. serves the purpose of eliminating  conflicts  somewhat.   If
  102. conflicts  do  arise, they will be resolved on a first come,
  103. first served basis.
  104.  
  105. _2._3.  _I_n_t_e_r_n_e_t _a_d_d_r_e_s_s_e_s.
  106.  
  107.      Associated with each host is an Internet address.  This
  108. is  the actual "name" for the host as far as other computers
  109. are concerned; they are unique throught  the  world.   These
  110. addresses  are  written  as  four numbers separated by dots,
  111. e.g. 128.104.39.10; each number can be anything  from  1  to
  112. 254, inclusive.  This number is the "interface" field above.
  113. I will assign a number at the same time  that  you  register
  114. the  official name and nicknames.  In general, they will all
  115. start with 128.104 since that is the number  that  has  been
  116. assigned to the campus network.
  117.  
  118.      If you are a large department and expect to  install  a
  119. local  ethernet  with many hosts attached, you will probably
  120. be assigned a block of Internet addresses, e.g. 128.104.38.1
  121. through  128.104.38.254  (0  and 255 have special meanings).
  122. The third number (38 above) will be a "building number".  Do
  123. not  assume  that  it is the building number obtained from a
  124. current parking map; These change every year and  you  would
  125. not  be  happy  if  you  had to change your Internet address
  126. after people are used to using it.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. May 22, 1987                                          page 3
  138.  
  139.  
  140. _3.  _C_o_n_f_i_g_u_r_a_t_i_o_n.
  141.  
  142.      There are configuration parameters that will have to be
  143. set before a host is connected to the network.
  144.  
  145. _3._1.  _I_n_t_e_r_f_a_c_e_s.
  146.  
  147.      In order to connect a host to  the  network,  you  will
  148. have  to  tell  it what its Internet address is and possibly
  149. some other properties of the network being connected to.  On
  150. Unix  systems,  this is done with a command in /etc/rc.local
  151. that should look like:
  152.  
  153.      ifconfig qe0 128.104.30.10 -trailers
  154.  
  155. The command will look the same on Wollongong systems  except
  156. that  it  appears in [NETDIST.MISC]STARTINET.COM.  The "qe0"
  157. above may vary depending on the type of hardware  you  have;
  158. your  installation  instructions should clarify this.  Other
  159. operating systems or TCP/IP software may differ,  but  there
  160. will generally be a configuration parameter called "internet
  161. address", or "interface address", or "IP number",  or  some-
  162. thing like that.
  163.  
  164.      On many systems, it is possible to use a symbolic  name
  165. instead  of  the  actual  number.  I have found that this is
  166. generally unwise.  If something happens to  the  file  (e.g.
  167. /etc/hosts)  that  is  used  to establish the correspondence
  168. between this name and the internet address, the machine will
  169. not  boot  correctly.   Note  that  this includes the use of
  170. backquoted `hostname` in the configuration files distributed
  171. by  Berkeley  and Ultrix.  If you do use a symbolic name, be
  172. sure that the name-number association is under your  control
  173. and not something that you rely on someone else providing.
  174.  
  175. _3._2.  _T_r_a_i_l_e_r _e_n_c_a_p_s_u_l_a_t_i_o_n.
  176.  
  177.      If there is any mention of "trailer  encapsulation"  in
  178. your  TCP/IP  configuration, please make sure it is disabled
  179. (that's the "-trailers" above); there are many hosts on  the
  180. network that cannot understand this feature.  If this is not
  181. mentioned, then you don't have it, so don't worry about  it.
  182. This  is  an  "enhancement" that was done at Berkeley and is
  183. really only useful on networks where everyone runs Unix.
  184.  
  185. _3._3.  _S_u_b_n_e_t_s.
  186.  
  187.      If you have subnetting support, we don't use  it  here.
  188. You  can  either  use  the  default  or specify a netmask of
  189. FFFF0000 (hex).  This usually won't be a concern unless your
  190. host  used  to  be  on  a network where subnetting was used.
  191. This may change in the future if enough hosts  have  subnet-
  192. ting support.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. May 22, 1987                                          page 4
  204.  
  205.  
  206. _3._4.  _B_r_o_a_d_c_a_s_t _a_d_d_r_e_s_s.
  207.  
  208.      If you have the option of specifying all zeros  or  all
  209. ones  for  the  broadcast address, this should be set to all
  210. zeroes.  E.g, in BSD4.3 Unix and Ultrix, the "ifconfig" com-
  211. mand  should  contain  "broadcast 128.104.0.0" as an option.
  212. The standard broadcast address is all ones,  but  there  are
  213. still  many  hosts that are based on BSD4.2 Unix, so we have
  214. to stick with that until everyone can  change.   Many  newer
  215. releases  of  TCP/IP  come  with the "all ones" as a default
  216. since it is the standard.  If that is the case, be  sure  to
  217. change it back to all zeroes.
  218.  
  219.      One of the things provided with Unix systems that  uses
  220. broadcasts  is  the "rwho daemon".  For the time being there
  221. is no objection to running it; however, in the future we all
  222. may  have  to  disable  them  if they cause too much network
  223. traffic.  If you have BSD4.3, I would like you to check with
  224. me before starting the rwho daemon.  The one that comes from
  225. Berkeley is often not suitable.
  226.  
  227. _3._5.  _L_o_o_p_b_a_c_k _i_n_t_e_r_f_a_c_e.
  228.  
  229.      All software comes with a  "loopback"  interface.   The
  230. conventional  number for this is 127.0.0.1.  On most systems
  231. this is supplied automatically and you needn't  worry  about
  232. it.   BSD4.3  and  newer  Ultrices allow you to configure it
  233. just like any other interface; such systems will need a
  234.  
  235.      ifconfig lo0 127.0.0.1
  236.  
  237. (trailers are OK here since you're  only  talking  to  your-
  238. self).
  239.  
  240.      The first few tests you perform on your host should  be
  241. using  this  interface  (e.g.  telnet 127.0.0.1).  This will
  242. verify that the networking code is operational before  send-
  243. ing packets out all over the campus.
  244.  
  245. _3._6.  _T_e_s_t_i_n_g.
  246.  
  247.      For purposes of testing your configuration,  the  above
  248. should be enough.  It will allow you to communicate with any
  249. host on the local network (any host with a 128.104 number).
  250.  
  251.      It would be best to disable as many unnecessary  things
  252. as  possible for the initial test (e.g. rwhod, routed, send-
  253. mail, etc).  If you are unsure of youself, you  can  get  in
  254. touch with me when you do this.  I have tools that I can use
  255. to "snoop" around on the network and  see  if  machines  are
  256. misbehaving or not.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266. May 22, 1987                                          page 5
  267.  
  268.  
  269.      Many departments have given me guest accounts on  their
  270. hosts so that I can look over things.
  271.  
  272. _3._7.  _R_o_u_t_i_n_g.
  273.  
  274.      In order to communicate with the rest of  the  Internet
  275. world  (i.e.   the  ARPAnet and the NSFnet) you will need to
  276. tell your host where a gateway  is.   The  gateway  here  is
  277. named  "unix2.macc.wisc.edu"  and  also  known as "Steer" or
  278. "Wilt"; its Internet address is 128.104.30.1.  If you are on
  279. the  USAN network (net 128.116 in Meteorology and Space Sci-
  280. ences for now), then the gateway's address is 128.116.12.1
  281.  
  282.      NCAR will tell you to use 128.116.64.1;  don't  believe
  283. them.   This gateway can be used if you never talk to anyone
  284. but NCAR.  The USAN folks should also keep it  in  mind  for
  285. use  if  our  gateway  goes down; they can reconfigure using
  286. 128.116.64.1 and still be able to at least talk to NCAR.
  287.  
  288.      If  your  host  is  on   some   other   network   (e.g.
  289. 192.12.224),  then  there's a gateway between you and Steer.
  290. Find out which it is and what its address  on  your  network
  291. is.   That's  where your default route would go.  It may not
  292. be possible for such networks to reach  the  external  world
  293. for  now; there is a limit to the number of networks on both
  294. the ARPA- and NSF- networks and we wouldn't be  too  welcome
  295. if we used more than "our share".
  296.  
  297.      There are two different ways to tell  your  host  about
  298. the gateway.
  299.  
  300.      (1) You can specify a "default"  route.   On  Unix-like
  301. systems,  this  would  be done with a command in the startup
  302. file that looks like:
  303.  
  304.      route add default 128.104.30.1 1
  305.  
  306. (the "1" on the end is important).  On other systems,  there
  307. will probably be mention of a "default gateway" or something
  308. like that in the configuration.  128.104.30.1 is the  number
  309. to use (128.116.12.1 for the USAN folks).  What you are tel-
  310. ling your host is to relay all communication with hosts hav-
  311. ing an Internet address other that 128.104-something through
  312. the gateway.  The gateway runs special software that  learns
  313. about  all the other networks on the Internet and how to get
  314. to them.
  315.  
  316.      (2) If you do have a "routing daemon"  (/etc/routed  on
  317. Unix  systems)  you  can run it instead; it will learn about
  318. the default route and take care of it for you.  This is  the
  319. preferred  method  since  it  will also take care of the day
  320. when we have alternate gateways to the  external  world  and
  321. automatically  switch  to a backup if one goes down.  If you
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332. May 22, 1987                                          page 6
  333.  
  334.  
  335. do have a Unix-like system  with  the  routing  daemon,  you
  336. should  use the "-q" option; this tells it to only listen to
  337. routing information and not supply it (most hosts have noth-
  338. ing  interesting  to  say  about their routes; only gateways
  339. have interesting things to say).  _D_o _n_o_t  use  the  "-g"  or
  340. anything  that  would  cause your host to announce a default
  341. route; if you do, you will be getting a nasty call from  us.
  342. Do not use this even if you are a gateway.
  343.  
  344. _4.  _M_a_i_l_i_n_g _l_i_s_t_s.
  345.  
  346.      A mail reflector (mailing list) has been established on
  347. the  gateway.   It  is  intended  to be used for messages of
  348. interest to the systems programmers that are actually  main-
  349. taining  the  TCP/IP  software  of  sundry hosts.  This mail
  350. reflector is "netfolks@unix2.macc.wisc.edu"; mail to it will
  351. be  sent  to all the systems programmers.  When you get your
  352. system up and running, you could  send  a  message  here  to
  353. "introduce  yourself".  Questions about availability of net-
  354. work software, announcements of major  changes  (such  as  a
  355. gateway  being  down  for  an  extended  period),  etc.  are
  356. appropriate.  Inquiries about statistical  software  or  the
  357. like  belong  on  some  other  mailing list that hasn't been
  358. created yet (suggestions and volunteers are welcome).
  359.  
  360.      There  are  also  subreflectors   "netfolks-unix"   and
  361. "netfolks-vms"  (both  at  Steer)  for  messages peculiar to
  362. those operating systems.
  363.  
  364.      When you get your mail system up and  running,  let  me
  365. know  who  to  add  to  this list.  Most people establish an
  366. alias (netadm is common) so that this list doesn't  have  to
  367. be  changed  if  someone else takes over the network hacking
  368. duties on a host.  Mail to "netadm@unix2.macc.wisc.edu" will
  369. get to me.
  370.  
  371. _5.  _N_a_m_e_s_e_r_v_e_r_s.
  372.  
  373.      There is a nameserver running on Steer that serves  all
  374. the  subdomains  (departments) of wisc.edu.  There is also a
  375. "nickname domain" that contains all the nicknames.   If  you
  376. are using nameserver software and expect to communicate with
  377. campus hosts outside your department,  the  nickname  domain
  378. would  probably  be  the  best  one to use as your "default"
  379. domain.  This domain is "nn.wisc.edu"; e.g. in Unix  systems
  380. running   BIND,   you  would  put  "domain  nn.wisc.edu"  in
  381. /etc/resolv.conf.  If you don't know what I'm talking  about
  382. here, you needn't worry about it; the nameserver business is
  383. new and still somewhat experimental.
  384.  
  385.      One problem you may notice because of this is that some
  386. of  your  users  may  not  be able to mail to certain hosts.
  387. This is often because such hosts are  known  to  the  domain
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398. May 22, 1987                                          page 7
  399.  
  400.  
  401. system (the nameservers) but not in the host tables.  If you
  402. suspect that this is the case, relaying the mail through the
  403. gateway  might  be  worth a try.  I.e. you could try sending
  404. mail to
  405.  
  406.      user%funny_host@steer
  407.             - or -
  408.     <@steer:user@funny_host>
  409.  
  410.  
  411. _6.  _P_h_y_s_i_c_a_l _N_e_t_w_o_r_k _C_o_n_n_e_c_t_i_o_n.
  412.  
  413.      MACC operates the campus-wide  Ethernet  based  on  our
  414. broadband  cable  system.   See  MACC  document  #1937, "UW-
  415. Madison Networks" for specifics  and  applications  details.
  416. All  equipment  directly  attached to the broadband Ethernet
  417. (i.e. Chipcom transceivers and LAN-100's) must be maintained
  418. by MACC.
  419.  
  420.      If you suspect hardware problems with  this  equipment,
  421. call  the  MACC  Communication  Facility,  263-4829, or Mike
  422. Dorl, 262-0466.  It would probably be best to get  in  touch
  423. with  Mike  or  me first so that we can verify that it looks
  424. like a hardware problem from "our side" too.
  425.  
  426. _7.  _R_e_a_d_i_n_g _m_a_t_e_r_i_a_l.
  427.  
  428.      In addition to the  documentation  provided  with  your
  429. system, MACC has some general user level documentation.  The
  430. title is "Wisconsin IP Network User Manual", MACC #1103  and
  431. is available from the documentation desk in the lobby.
  432.  
  433. _8.  _M_i_s_c_e_l_l_a_n_e_y.
  434.  
  435. _8._1.  _H_o_s_t _t_a_b_l_e_s.
  436.  
  437.      Host tables are available via anonymous  FTP  from  the
  438. gateway.   Login  as  user "anonymous"; password can be any-
  439. thing; most use "guest".  After logging in,  change  to  the
  440. directory  "etc".   the file "hosts" is in Unix (Wollongong,
  441. Ultrix) format.  It contains all the local hosts  and  nick-
  442. names  at the front followed by the rest of the hosts avail-
  443. able from NIC.  The files "depthosts" and  "localhosts"  are
  444. subsets of this.
  445.  
  446.      The file "localhosts.txt" contains Wisconsin hosts  and
  447. nicknames  in NIC format (IBM, CMU TCP/IP, Apollo, etc), the
  448. file "hosts.txt" is a fairly recent copy of the tables  dis-
  449. tributed  by  NIC.   For  NIC format hosts, "localhosts.txt"
  450. concatenated with "hosts.txt" is usually what you want.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461. May 22, 1987                                          page 8
  462.  
  463.  
  464. _8._2.  _S_e_c_u_r_i_t_y.
  465.  
  466.      If you are used to running a very  relaxed  system  and
  467. not  using  passwords, I would advise you to institute them.
  468. There seem to be people around the world who will  try  con-
  469. necting  to  random  hosts.   If  they get logged on to your
  470. machine, they just might try to demonstrate how "cute"  they
  471. can  be.   Another  hint:  if  a password is the same as the
  472. login name, it's effectively not  a  password.   That's  the
  473. first thing I would guess and the first thing a lot of other
  474. people would guess too.
  475.  
  476. _8._3.  _B_o_o_t _s_e_r_v_e_r_s _a_n_d _t_h_e _l_i_k_e.
  477.  
  478.      Some diskless workstations and other hardware expect  a
  479. "boot  server"  to  be  available  on  the  network.  Do not
  480. install such a server on 128.104 unless you check  with  us.
  481. People  will be quite unhappy if your boot server bootstraps
  482. their workstation.
  483.  
  484. _8._4.  _A_R_P
  485.  
  486.      Some older systems (e.g. Sun and old 4.2BSD's)  do  not
  487. use  ARP  for certain host numbers (less than 1024 usually).
  488. This causes no probelms on a class C network  (192  numbers)
  489. but won't work on our class B network (128.104).  If this is
  490. the case, you'll need to get a fix from the vendor.  If  you
  491. have   a   Unix   system   and  can  recompile  the  kernel,
  492. sys/netinet/if_ether.c is the  place  to  look.   There's  a
  493. "#define"  in  there (I just changed it to 666666 when I had
  494. to do this, there's no particular  reason  for  that  number
  495. other than it's larger that 65536).
  496.  
  497. _8._5.  _D_E_C_n_e_t
  498.  
  499.      If your host also has a  DECnet  connection.   Remember
  500. that TCP/IP cannot be started until DECnet is running.  This
  501. is because DECnet needs to start  first  to  initialize  the
  502. hardware  interface  for  it's own purposes.  TCP/IP can use
  503. what DECnet sets up.  Be sure that the instructions you have
  504. say  that  is  is indeed possible to share the Ethernet with
  505. DECnet.  With some systems (e.g. Wollongong), extra  options
  506. are necessary to do this.
  507.  
  508. _8._6.  _M_a_i_l
  509.  
  510.      The official BITnet gateway is WISCVM.WISC.EDU.  If you
  511. want  to send mail to a BITnet user but do not have a BITnet
  512. connection, mail addressed to either
  513.  
  514.      user%node.bitnet@wiscvm.wisc.edu
  515.                  - or -
  516.     <@wiscvm.wisc.edu:user@node.bitnet>
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527. May 22, 1987                                          page 9
  528.  
  529.  
  530. should get there.  Some hosts cannot handle the latter  form
  531. of address properly.
  532.  
  533.      Similarly, our VMS critters can be used to relay  local
  534. DECnet mail, e.g.
  535.  
  536.      user%node.decnet@bossie
  537.              - or -
  538.     <@elsie:user@node.decnet>
  539.  
  540.  
  541.      Some Unix-like systems (Ultrix in particular) have con-
  542. figuration files for sendmail that just plain don't work.  I
  543. can give you one that does.
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.